home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 21 / CU Amiga Magazine's Super CD-ROM 21 (1998)(EMAP Images)(GB)[!][issue 1998-04].iso / CUCD / Games / AmiDoom / amidoom.readme < prev    next >
Text File  |  1998-01-08  |  6KB  |  195 lines
  1. Short:    Doom port for the Amiga - v0.5
  2. Author:   e4geeln@etek.chalmers.se (Marcus Geelnard)
  3. Uploader: e4geeln@etek.chalmers.se (Marcus Geelnard)
  4. Version:  0.5
  5. Type:     game/shoot
  6.  
  7.  
  8.                                AmiDoom v0.5
  9.  
  10.                                 1998-01-06
  11.  
  12.                          ported by Marcus Geelnard
  13.  
  14. Requirements
  15. ============
  16.  
  17. The minimum required system for running AmiDoom is:
  18.  
  19.  * 68020 (no FPU needed)
  20.  * 6MB of FAST ram (or you can use VMM)
  21.  * OCS/ECS/AGA or a graphics-card
  22.  * AmigaOS 2.0+ (or 3.1+ for best gfx-card support)
  23.  * ixemul.library v45 or later
  24.  * A proper wad-file (I have tested Doom I shareware and Doom II registered)
  25.  
  26. However, I recommend at least:
  27.  
  28.  * 68030-50MHz
  29.  * 8MB of 32-bit FAST memory
  30.  * A graphics card
  31.  
  32.  
  33.  
  34. Running AmiDoom
  35. ===============
  36.  
  37. It couldn't be much simpler... Just place the AmiDoom executable in a
  38. directory together with a Doom wad-file (where all the game data is stored,
  39. like maps, pictures, textures, sounds etc). Then run it. Voila!
  40.  
  41. I have made a small script called StartDoom, that launches AmiDoom (either
  42. from Workbench or from Shell). You can edit this script, and add your
  43. favourite parameters to AmiDoom (e.g. how many audio-channels to use).
  44.  
  45.  
  46.  
  47. Graphics
  48. ========
  49.  
  50. AmiDoom opens its own screen. This screen will have 256 colors, if your
  51. system supports it, or it will use 64 colors, if you only have an OCS/ECS
  52. graphics chipset.
  53.  
  54.  
  55.  
  56. Sound
  57. =====
  58.  
  59. AmiDoom has full sound-support with real stereo panning. It is implemented
  60. with a very fast double-buffered 16-bit mixing-routine and 8-bit stereo
  61. sound output. Everything goes through audio.device, so no hardware banging
  62. is done, and no extra drivers are required (like AHI). Although AmiDoom can
  63. play up to 16 channels of sound, you rarely need more than 3 channels, which
  64. is the default.
  65.  
  66. However, it uses up quite some memory (for loading all sounds from the wad-
  67. file), and if you use many channels, it is bound to eat some CPU-time. On a
  68. fast Amiga with much memory (like a 68040 with 8MB FAST memory), this is not
  69. really a problem, but on a slow machine (like mine), it can be wise to play
  70. around with the sound-parameters (see flag descriptions below) to get the
  71. best result.
  72.  
  73.  
  74.  
  75. Keyboard
  76. ========
  77.  
  78. I used an Amierican layout of the keyboard (like in the original PC Doom-
  79. version). There are two differences between the PC layout and the Amiga
  80. layout however: F11 is mapped to Del on the Amiga (which changes the gamma
  81. level), and Pause is mapped to Help on the Amiga.
  82.  
  83.  
  84.  
  85. Stack
  86. =====
  87.  
  88. It seems that you need a stack of about 40000 bytes to run AmiDoom. To set
  89. the stack-size, use the command 'stack 40000' from the shell that you are
  90. running AmiDoom from. This is automatically done in the startup-script
  91. "StartDoom", which can be run from the Workbench.
  92.  
  93.  
  94.  
  95. Slow hard-disk loading
  96. ======================
  97.  
  98. You might notice that it takes (nearly) forever to load wad-data from your
  99. hard-disk. The remedy is (if you have enough memory for it) to add some
  100. buffers to the disk that you have installed AmiDoom on, with 'addbuffers'.
  101. Adding about 300-800 buffers (150-400 KB) has a tremendous impact on loading
  102. aswell as playing (loading is done during game-play too).
  103.  
  104.  
  105.  
  106. Networking
  107. ==========
  108.  
  109. I have not been able to test the network support, but I have gotten reports
  110. from users saying that they have had success running network-games with
  111. AmiDoom. Ridwan Hughes said this in a letter to me:
  112.  
  113. "Just to let you know, the networking side of it does work, I tested it on
  114. a serial TCP link between my A1200 and A2000, have to set a high baud rate
  115. and low MTU (as low as 128) to make the updating of both displays smooth
  116. enough to be almost playable (plus I need something better than an 030 in
  117. both machines ;)"
  118.  
  119.  
  120.  
  121. Switches
  122. ========
  123.  
  124. You can use the following Amiga-specific switches when starting AmiDoom:
  125.  
  126.  Graphics:
  127.  
  128.  -aga          Forces AGA optimized c2p routine to be used. This is default
  129.                on AGA systems without a graphics-card.
  130.  -ecs          Forces ECS modes to be used. This is default on ECS systems
  131.                without a graphics-card.
  132.  -noehb        When ECS is used, use a grayscale display instead of the
  133.                default 64-color display.
  134.  
  135.  Sound:
  136.  
  137.  -nosound      Turns of sound output.
  138.  -channels n   Use n audio-channels, where n is between 2 and 16 (default 3).
  139.  
  140.  
  141.  
  142. Background
  143. ==========
  144.  
  145. AmiDoom is based on the free source-code for Doom v1.10 (for Linux), which
  146. was released on 24-Dec-1997. I got interested in porting it when someone on
  147. a bulletin-board mentioned that the source had been released, and asked if
  148. there were any efforts being made to port it to the Amiga.
  149.  
  150. It took about one day to make it work on my Amiga 3000, and one more to fix
  151. faster and better graphic support (of which about 6 hours went to tracking
  152. down a stupid bug - I had commented out one source-line too many). For me
  153. this was a challenge, as I had never really written complex code like this
  154. in a system-friendly manner: multitasking, AmigaOS screen and window, timers,
  155. keyboard and mouse input etc. However, it turned out to be very nice. Almost
  156. everything worked after the first compilation (!).
  157.  
  158.  
  159.  
  160. What is implemented?
  161. ====================
  162.  
  163.  * Fast native CyberGraphics, AGA and ECS/OCS support.
  164.  * Full sound-support, with real stereo-panning.
  165.  * Keyboard and mouse control.
  166.  * Support for several Doom wad-files (Doom I shareware and Doom II
  167.    registered version have been tested, and work fine).
  168.  * Networking.
  169.  
  170.  
  171.  
  172. Todo
  173. ====
  174.  
  175.  * More speed-ups.
  176.  * Verify that more wad-files work with AmiDoom.
  177.  * Joystick support.
  178.  * Fix more bugs (I do not currently know of any).
  179.  * ...suggestions?
  180.  
  181.  
  182.  
  183. Contacting me (bugs etc)
  184. ========================
  185.  
  186. First of all: AmiDoom is freeware! (you do not have to pay a penny for it)
  187.  
  188. For bug-reports (or success-reports) and comments, I can be reached at:
  189.  
  190.  e-mail:  e4geeln@etek.chalmers.se
  191.  
  192. Updates and support can be found at:
  193.  
  194.  WWW:   http://www.etek.chalmers.se/~e4geeln/amidoom/
  195.